Release notes

2021r1.000

API version: v1.0.0

Addition of File API

From this version on, it is possible to transfer files using the File API

File API service

A File API service, i.e. BAPIFileService has been created. This service handles all file API calls and moves files around. Files can be converted to REST calls and REST calls can be converted to files. This service is REST aware.

In the FOLDERS group box, the folders to use for this integration and the number of retries need to be specified. When the maximum retry count has not been specified, it is zero by default.

The GET files call

  • This call returns the oldest or newest file, depending on the parameter in the call, from the Source folder. A check will be done to exclude files that are locked by other processes. This happens to avoid that files would be picked up that are being written or are in the process of being moved to a different folder. Then the file goes to the Processing folder.

  • In the header of the reply, the filename, the extension and the checksum are provided.

  • The GET API call returns the YAML file.

The POST acknowledge

  • This call identifies the file that needs to be processed, based on the filename and the checksum.

    • When the response is OK, the file will be moved to the Processed folder.

    • When the response is ERROR, after the specified number of retries, the file will be moved to the Failed folder.

  • This call is logged by the service. In the file API log entry browser, users can search for these file API logs.

File API log entry browser

A File API log entry browser has been created to search for file API logs.

File API log entry maintenance task

The maintenance service allows reducing the number of records stored in a log entry list by removing outdated entries. It contains maintenance tasks that can be configured to regularly clean up the list. A maintenance task can be created to clean up the file API logs as well with the following properties:

  • Number of days to keep: type or select for how many days the file API log entries will not be deleted. After the specified amount of days, the task will delete them.

  • File API interfaces: type or click to choose the file API interface.

Opening file API logs in REST exchange log entry navigator

The REST calls of the different REST interfaces can be retrieved from the REST exchange log entry browser. When opening such an entry for the file API, the navigator tries to fetch the entire response body. For some file formats, for instance PDF, this can give performance issues. Therefore, the response body will not be shown for file API calls.